Xbasic

UI_DLG_CREATE Function

Syntax

V UI_DLG_CREATE(C title,C format[,C code])

Arguments

title

The title of the dialog.

format

A series of Xdialog commands that describe the appearance of the dialog box.

Argument
Description
<<%dlg%

The only optional part of this argument is the "dlg" sequence of characters (the marker), which can be any string of characters, as long as it is unique within this instance of the UI_DLG_BOX() function. The character sequence <<%dlg% is specifically recommended because it is supported by bubble help.

Xdialog_Code

One or more statements, each of which must be on a separate line from the <<%dlg% and %dlg% arguments.

%dlg%

The marker characters can be any string of characters, as long as they match those in the first argument ( <<%dlg% ).

code

Optional. Xbasic code that describes what should happen when various events happen when the user is interacting with the dialog box. For example, what should happen when the user presses a button, or when the user tabs out of a field.

Description

Create an invisible modeless dialog (which can be later shown).

Discussion

The UI_DLG_CREATE() function creates an invisible modeless dialog, which can later be displayed.

Example

This example creates an invisible dialog with UI_DLG_CREATE(), then displays it with UI_DLG_SHOW().

ui_dlg_create("Invisible Xdialog", <<%dlg%
<20,3Click Here>
%dlg%)
ui_dlg_show("Invisible Xdialog")

Limitations

Desktop applications only.

See Also